IApi.Create 方法

准备将程式连结到 KINGSTAR 子系统。

组合： IntervalZero.KINGSTAR.Base.Api (于 IntervalZero.KINGSTAR.Base.dll) 版本：4.4.0.0

语法

KsError Create(
       int Instance,
       int IdealProcessor
)

Function Create(
       Instance As Integer,
       IdealProcessor As Integer
) As KsError

参数

Instance

型别：int

在有多主站套件的情况下选择想要使用的 KINGSTAR Runtime 实例。若没有此套件，请将其设定为零 (0)；若有此套件，则有效的实例应为 0 <= instance <= 63。此实例可依照您的需要而设，例如：您有三个实例并想使用第三个，则将之设为二（2）。

IdealProcessor

型别：int

设定 KINGSTAR 子系统运作的核心。子系统的所有执行绪将在给定的处理器上运作。核心零固定分配给 Windows。您可根据您的设定将其他核心分配给子系统。预设情况下，IdealProcessor 设定为零，表示 KINGSTAR 将使用实例配置表中所配置的处理器（KINGSTAR 控制台 > Runtime 设定 > 一般设定）。若该表中缺少给定实例的设定，则子系统可在 RTX64 可用的任何核心上运作。若您将 IdealProcessor 设定为其他数字，例如二，则子系统将使用核心二。

回传值

型别：KsError

方法的回传值。

备注

• 此方法应第一个被呼叫。若未先呼叫 Create 方法，则所有其他方法都会回传错误。
• 若未启动 多主站套件，使用此方法且 Instance 设定大于零时，将回传 errNoLicense。在没有 多主站套件 的情况下，仅能将 Instance 设定为零。
• 多实例代表您有多个 ksRuntime.rtss 同时执行中且控制著不同的网卡，若您备有 多主站套件，可使用多个 Create 来建构多个实例。例如，有三个 Create 函式，则这些函式可各自使用实例零、一和二；若没有 多主站套件，您可使用多个 Create 来建构唯一一个实例，即实例零。多个应用程式可连结到同一个 KINGSTAR Runtime，但单一应用程式不可连结到多个 KINGSTAR Runtime。
• 一个 KINGSTAR Runtime = 一个 ksRuntime.rtss。
• Create 方法不能从执行绪集区或背景执行绪中呼叫，因为某些 RTX64 元件无法从这些位置初始化。

范例

N/A

参见

IApi 介面

IntervalZero.KINGSTAR.Base.Api 命名空间